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Ih«ie fine Slnclalrs, mnlsct ihe: 

Chairman 

Chief Motivator 
DonaJd S, Lambert 
738 Gunnar Ld. 
Forsyth, IL 62535 

Vice-Chairmen 



Tape &JLO PD Library 

D G. Smith 
415 Stone St. 
Johnslown. PA 15906 
814 535-6998 

Z88 Library 
Dave Bennett (HATSUG) 
1275 Timber View Dr. 
Mechaiic^rg, PA 17055-9146 
717 732-4374 

QL Hacker's J 

Timothy Swenson 
2455 Medallion Dr. 
Union City, CA 94587-1914 



TS-206S 
Rod Humphreys (VSUG) 
10984 Collins PI. 
Delta, BC V4C 7E6 Canada 
604 583-2819 

QL PD Library 
John Donaldson (CATUG) 

835 Foxwood Cir. 
Geneva. IL 60134-1631 
630 232-6147 

AERCO & Z80 Emulator 

Keith Watson 
41634 AmberiyDr, 
Mt. Clemens, Ml 48038 

BBS — =GATOR=— 

Bob Swoger (CATUG) 
613 Parkside Cir 
Streamwood. IL 60107-1647 
630 837-7957 Work S47 576-806S 



Any of the above can also be 
reached by E-Mail through the 
Club BBS 847 632-5558 
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nex/Sini 



ing 



the T/S com- 
mnilv in a VOLUME of four 
ar; beginning with 

■) ' 



T/SNUG's main goal is to 
preserve and encourage the 
use of Sinclair computers 

by providing an open 
forum for the exchange of 
knowledge, building and 
maintaining of software 
libraries. Providing 
vendors, repair service and 
members with free ad 



It is the user groups and individual 
aubscribers, rather than the vendors, 
that provide the pecuniary support 
for this newsletter. Vendors and 
developers receive this newsiener 
;harge, thoi 



eralefiilly accepted. Please support 
our venuiirs ami suivjcu ririiu]iiri'<; 
whenever possible. 

If you have a problem or you have 
solved a problem, please share it with 
the test of us. No problem will be 



Puhlisher 



■M O" can keep T/S>njG alive by 
S an annual contribution of 112 
for one VOLUME made payable to 
Abed Kahale. Send check to - 

ABED KAHALE 
3343 S FLAT ROCK CT 
SIERRA VISTA AZ 85650-6874 



Back copies are available for 
SIM each postpaid. 



iVs of September 

balance of 1840,22 



Article 
Contributions 



Send in your articles by di.sk. hardtapv nr 
mail, e-mail and your inputs to.- 
Abed Kahale 
K-mail AKahale@compuserve. com 

^EtDistEb fait 

'^0 better infonn the Sinclair Community, IhrcK 

Q'BoxBBS 810 254-9878 

Utica, Michigan 
SOL BBS 520 882-0388 

Tucson. Arizona 
Club BBS 847 632-5558 

Arlington Heights, lllineiis 

We h Pages 

http,//users-ao[.clubbfas/tsnug/ 
http ://www.o utia wn et , com/~j boatno4 

Jf you know the Intemcl E-Moil address of a 



We encourage you to exchange n 
contnbuls to the UPLOAD setU 



. Coll 



:g your tiist, last ai 
iber along with a password you won't forget 
lE /( Dovh! Do nnl try to do anything else at 

lu will havi 



T^^Tlen you call- 



ivilEges. The BBS bus smaller sections 
called conferences. Select "S " for "Join a Confer- 
ence" Select 'TIMEX" to get into the Sinclair 
Secuon. The mail you then read will only be from 

.ADS for ads and NWS for news when 
UPLOADing 

Jpcrhelp.oonlaettheSVSOP.BobSwoger, by 
CENGIOS@email.mot.com 
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Abed. 

1 have B joystick, a Wickcs roller ball, and sketchpad 
eic, lhal 1 would be thrilled to donaie in hopes that someone 
would enjoy playing with them. Some have not been lired 
up in a decade but were working then. Also 1 have both 
cassettes and cartridges (commercial programs) from 
Timex and Psion, etc. 1 will give my old 300 Baud 
mo [I em 5 and everything except my bare bones LarKen and 
Zebra systems with the 2 little printers. I will also give my 
two Banaoa Gorillas - one a serial and one a parallel. I 
will pay shipping to our two surplus places, 1 am on verge 
of having to rent a storage chamber monthly to calm the 
clutter around here. 

. Joan Kealy 

Thanks! Abed, for sending the Spring and Summer 
issue's of the 2Xir Alive Newsletter. I did not get them for 
some reason. Must be our mail 

Sony to hear about your wife. Also, sorry, that 1 didnt 
get back to you about tbe ZXir newsletter's. My IBM was 
down last week, I'm having to re-install stuff on my 
machine and it's going to take me at least a month to gel 
everything back up and running righll! 
Thanks again for the newsletter! I 

Pane Sleeman 

Dear Mr. Kahale, 1 have been studying code 
programming for the Timex Sinclair TS 1000. I have had 
some modest success, and I'm very interested in being in 
touch with other Z80 users. Thank you for any info you can 
toss my way, Respectfiilly yours, 

StephcD Waldman 
brogine@hotmail.com 

/ kno<n there is one person who is good at the 
ZBQ code- 
Keith Watson 
Keith_ watsorj@iuno. com 

There is a very active group in Germany for the 
ZX-81 but, one t ias to know German. 
Hello Abed: ~ ~ " 

My name is Richard Burl, and I am a long time 
Timex Sinclair user, and former dealer in this area, I 
belonged to several TS groups in Canada, all of which art 
gone now. and I still long for info of the TS brotherhood. I 
still use my Sinclair computers although not as much as I 
used to, just the 2068, and the QL now. 

If you would email mc back the information 
reguarding membership, and the mailing address, ii would 
be much appreciated, ITianks in advance Rick 
Sender: ajbt^intranel ca 

bobs wogengju no, com 
CENG108@email mot.com 

Begin forwarded message 

From; William McBtine <wmcbrine@clark,net> 
From: "Richard Dodds" <dicky@popup,freeserve.co.uk> 
—Original Message 



From' owner-305B@unixvLlle com [mailto.owncr- 

2068@uni«ille.com] 

On Behalf of William McBrine 

To: TS-2068 users 

Subject: Two-liner 

Of all the programs I've written for my TS206a, 
probably my favorite is this trivial little thing: 

10 POKE 2252S+RMD*767,RND^63 

20 GO TO 10 

It was supposed to print squares of random 
color at random locations on the screen, {Why? I 
dunno; that's jtist the stjrl of thing I did back 
then,) But it didn't quite turn out that way. As 
more squares were plotted, a distinct pattern 
emerged. 

This program exposes the "pseudo" aspect 
of the psuedo-random number generator, I also 
find it quite beautiful. The best part is that the 
location of each plot does appear random, and 
there's some margin of error, so that a particular 
cell may change colors a few times, while 
remaining within the overall pattern. Replacing 
"63" with "1 27" also works well. 

tf you reverse the order in which the two 
calls to RND are made, the effect is lost. - 
Wiltiam McBriue | htlp:W www.clark.Det/-wmcbrine/ 

wmcfarine^clark. net 

Hi Mr. Kahaie. 

1 gather Don doesn't do e-mail, I just wanted to say 
that I found the T/S web page. Vou might remember me 
from an article I wrote about 7 years ago for the newsletter 
on using the T/S 1000 with CompuServe, 1 still use my T/S 
1000 with the Byte-Back I/O board to control my model 
tram layout 1 was hoping I could write Don directly, but 
gather he still likes snail mail, :-) 

Glad to see his name at the top of the page, Don was 
very helpfiil to me, and 1 will never forget his kindness 
Please say "hi" for me. Taker care. 

Joe Ramjiolla, jj3rampolla@blazenet,nei 
HiAbei " 

Thanks for the reply! Yes 1 still have the article, but 
until 1 get a scanner I wont be ^le to e-mail it. Anyway, I 
doubt that CompuServe still handles its mail the way it did 
about 7 years ago, 

1 know Mr. Lambert didn't think he could handle an 
onlme service like CompuServe back when i was using the 
T/S 1 000 with CompuServe, 1 just bought a new PC, an E- 
Machine, and I am new to Windows, not to mention 
Windows 98 The old way with an ASCII interface and 
CompuServe was easy and less confiising for me Too 
much stuff on the screen, and the Internet is Kill of junk, 
and surfing can be a real waste of time, in my opinion. But 
at least I found the T/S web silellll 

1 look forward to e-mailing Mr, Lamben when he gels 
online, [ remember he moved a couple years before 1 



moved from Baltimore City, MD to here in Hanover, PA. 
Also look forward to keqjing in loucli with youl I would 
enjoy hearing ^lout others who still use the old Byte>Back 
I/O board, the BB-1 I had a real challenge figuring a way, 
on my own, to unpack the input byte. 
Take care, Joe, 

(His articte is in the Vol 2, No.2, Summer 1992) 

Dear Redneck 5or; 

I'm wrttiig this fetter alow because I know you 
conl read fast. 

We dont live wKere we d(d when you left home. 
Your dad fead In the newspaper thai most accidents 
happen wfthtn 20 mdes from your home, so we moved, 

I wont be able to send you the address 
becoLise the tast family that Ifved here tooh the house 
numbers when they moved so that they wouldn't 
have to change ther address. 

This ptace fs really nt.e. It even has a washiig 
machine. I'm not siye It works so well though; last 
weeli I put Q load h ond pulled the chain and hovent 
seen them s*ice. 

The weather Isnt bad here. It only ranied twice 
last week; the fi'st liTie for three days and the 
second time for fou" days. 

About that coat you wanted me to send you, 
your uncle Stanley said ;t would be too heavy to send 
In the maH with the brass buttons on, so we cut them 
off and put them in the pockets, 

John locked his keys h the truck yesterday. We 
were really worried because ft took htm two hours to 
9et me and your father out of the truck 

VoiiT sister hod a baby this morning; but 1 hovent 
found out what It Is yet so I dont know if your on aunt 
or an uncle. The baby looks Just Iflie your brother 

Uncle Ted fell in a whiskey vat lost week. Some 
men tried to pull him out, but he fought them off 
playfully and drowned. We had him cremoted and he 
burned for three days. 

Three of your friends went off a bridge fci □ pfc.k- 
ijp trucJi, Rolph was drivhg. He rolled down the 
wkidow ond swam to sofety. Vow other two friends 
were ri back. They drowned because they couldnt 
get the toUgote down. 

There Isnt much more news ot Ihb time. Nothing 
much has happened, 

Love, Mom 

P.5. I was goiig to send you some money but the 

envelope was already sealed, 

During tne' course of World War 11, many people 
gained fame in one way or anottier. 0ns man was 
Butch O'Hara. He was a fghter pilot assigned to an 
aircraff carrier in fhe Pacitic One time his entire 
squadron was assigned lo fiy a particular mission. 
After he was airborne, he looked a1 his fuel gauge 
and realized that someone had forgotten to top off his 
fuel lank. Because of this, he would not have enough 
fuel to complete his mission and gel back to his ship. 
His flight leader told him to leave formation and return. 
As he was returning to the mothership, he could see a 
squadron of Japanese Zeroes heading toward the 
fleet Id attack. And with all the fighter planes gone, 
the fleet was almost defenseless. His was the only 
opportunity to distract and divert them. 
ZXirQLiveAJivel ' ~ 4" 



Single-handedly, he dove into the formation of 
Japanese planes and attacked them. The American 
fighter planes were rigged with cameras, so that as 
they flew and fought, pictures were taken so pilots 
could learn more about the terrain, enemy 

Butch dove at them and shot until all his 
ammunition was gone, then he would dive and try to 
clip off a wing or tail or anything that would make the 
enemy planes unfit to fly He did anything he could to 
keep them from reaching the American ships Finally, 
the Japanese squadron took off in another direction, 
and Butch O'Hare and his fighter, both badly shot up, 
limped back to the carrier He lold his story, but not 
unlil Ihe film from the camera on his plane was 
developed, did they realize the extent he really went 
to, to protect his fleet He was recognized as a hero 
and given one of the nation's highest military honors. 
And, as you may know, O'Hare Airport in Chicago was 
named after him. 

Prior to this time, in Chicago, there was a man 
called Easy £ddie. He was working for a man you've 
all heard about, Al Capone. Al Capone wasn't famous 
for anything heroic, but he was notorious for the 
murders he'd committed and the illegal thing's he'd 
done. Easy Eddie was Al Capone's lawyer and he 
was very good. In fact, because of his skill, he was 
able to keep Al Capone out of jail. To show his 
appreciation, Al Capone paid him very well. 

He not only earned big money, he would get 
e>rtra things, like a residence that filled an entire 
Chicago city block. The house was fenced, antl he 
had live-in help and all of the conveniences of the 
day. Easy Eddie had a son He loved his son and 
gave him all the best things while he was growing up; 
clothes, cars, and a good education. And, because he 
loved his son he tried to teach him right from wrong. 
But one thing he couldn't give his son was a good 
name, and a good example Easy Eddie decided that 
this was much more important than all the riches he 
had given him. So, he went to the authorities in order 
lo rectify the wrong he had done. In order to tell the 
truth, it meant he must testrfy against Al Capone, and 
he knew that Al Capone would do his best to have 
him killed. But he wanted most of all to try to be an 
example and to do the best he could to give back to 
his son, a good name. So, he testified. 
Within the year, he was shot and killed on a lonely 
street in Chicago. 

These sound like two unrelated stones, but Butch 
O'Hare was Easy Eddie's son. 

For Cubs Fans 

20 major events that have occurred since the Chicago Cubs 

last laid claim to a wortd series championship: 

1. Radio was invented; Cubs fans gol to hear their team 

2 TV was invented; Cubs fans got to see their team lose. 
3. Baseball added 14 teams; Cubs fans gel lo see and hear 
their team lose lo more clubs. 

4 George Bums celebrated his 10th, 20th, 30lh, 40th. 50th, 
60lh, 70th, 80th, 90th and 1 00th birthdays. 
5. Haley's cornel passed Earth twice, 
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6. Hairy Caray was bora. ..and died. Incredible, but true. 

7. The NBA, NHL and NFL were formed, and Chicago 
teams won championships in each league. 

8. Man landed on the moon, as have several home nins 
given up by Cubs pitchers. 

9. Sixteen U.S presidents were elected 

10. There were 1 1 amendmenis added lo rhe Constitution. 

1 1 . Prohibition was created and repealed. 

12. The Titanic was built, set sail, sank, was discovered and 
became the subject of major motion pictures, the latest 
giving Cubs fans hope that something that finishes on the 
bottom can come out on top. 

13. Wrigley Field was built and becomes the oldest park in 
the National League. 

14. Flag poles were erected on Wrigley Field roof lo hold 
all of the team's fiiture World Series pennants Those flag 
poles have since rusted and been taken dowTL 

15. A combination of AO Summer and Winter Olympics 
have been held. 

16. Thirteen baseball players have won the Triple Crown; 
several thanked Cubs pitchers. 

17. Bell-bottoms came in style, went out of style and came 
back in style; disco did the same, 

18. The Chicago White Sox, Cleveland Indians, Boston Red 
Sox and Florida Marlins have ail won the World Series. 

19. The Cubs played 14,153 regular-season games; they lost 
the majority of them. 

20. Alaska, Arizona, Hawaii, Oklahoma and New Mexico 
were admitted to the Union. 
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n pUttu^ my ol. 
L my tiusty TS-206B. in a box and shipping it 
^Boatwright soon after I type this in. Why musl 1 do 
this? Il is because we are moving and have lo cut out a lot 
of extra stuff that is not longer needed - part of which is 
what my wife says. 1 will slill have the ZS8 and I plan to try 
to get active with that and of course 1 am thinking about a 
PC 



bought my first TS-2068 in 15 
f J^on deserted the TS-1000 1 we 
bad LOADS on the cassette mi 
LOAD AID and later learned lo use 
transformer lo LOAD questionable i 



:5 and from that point 
through the woes of 
s storage till I built a 
Snioa lOOOn audio 
; and when that 



failed r learned to use a Radio Shack miniamplifier to 
LOAD those thai failed with the transformer. Then in 1988 
1 went to the LaiKen disk drive and since then 1 used the 
cassette system as little as possible. After 1 moved to 
Indiana I acquired an Oliger disk interface and soon had an 
Oliger/LarKen interfece which I used till 1 sent the last of 
my equipment to Jack Boatwright. 

Mohave sent many boxes of my accumulation of 
■ jL^hardware, software and books, newsletters and 
magaidnes to Jack and now afier 1 finish this I will be 
boxing up my last shipment lo Jack 1 have set this up as my 
contribution to ZQAI for the FALL issue since 1 have no 
idea of how much time 1 wiU have available then lo write or 
to get a computer set up and running (or learning to use it). 
I guess I have learned lo no longer say never. Once upon a 
time 1 said 1 would never leave 
the TS-1000 but then along 
came the TS-206S. Then 1 said 
1 would never go to disk drives 



would never leave the TS-2068 
and here 1 am shipping my last 
one to Jack. I guess that 1 had 
better learn to say, "I don't 
plan to and that would be 
far closer lo the nuth. 
fe^ut I have leained a lot Itrol 
JjM about computi 

working with the TS- 
2068 (and the TS-1000) which 
is what I was after when 1 got 
into using them, have learned 
that the field is moving so fast 
that it is almost impossible lo 
keep up with the latest 
developments. If and when 1 
buy a PC 1 know that it will be 
obsolete before J get it out of 



the b 

get all the latest that 
afford and plan to have 
last big computer 
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again. As was packing the stuft thai 1 had to send Jack 
if 1 stopped to think about it I would never have gotten the 
first box packed. ! just could not stop lo son and pack stuff 
in categories more than 1 did. I do hope that Jack wasn't loo 
greatly upset about that 

^^e disk case next lo the keyboard on the computer 
W'j^desk has only three disks in il that have files on them, 
they are a disk of letters I have wrote, a disk of Oliger 
Utilities and a disk of personal finance. The later 1 have 
printed out all the important stuff (the latest file of each 
category) to lake with me to keep me acquainted with 
where our money is and how much we have. Or how much 
we will have left after the move 

Kknew nothing about disk drives when 1 got into thai 
field with the LarKen interface. I had lo learn how to 
[rouble shoot one particular type of disk drive (Tandon 
TM 100-2A); to reset track zero and speed I had to learn 
about the terminator resistor on the last drive on s ribbon 
cable and 10 set the proper jumpers to get it to operate. Now 
1 will be getting into hard drives with capacity of gigabytes. 
How much is a gigabyte? I just Can'l visualize how much 1 
am used to 5 K byles lo a track and 400K bytes to a disk so 
one gig is about 2,500 400 K disks. BUT! then the 
programs on a PC are so big. Get as big a hard drive as you 
can afford is what everyone lells me 
For those who travel with a ZB8 I have found that a soft 
cassette box will hold nine AA 
batteries if you twist off the little 
deals inside ihat keeps the reels 
from turning, of course the 



lid from completely 
ijn>?niir iiui a heavy rubber band 
wiji ciiii: mill. Two batteries will 
jjiy luii length of the case and 
the other seven will lay in there 

package tor travel. 
I have a parallel printer 
connecting cord for both the ZSK 
and the Laser PC3 which will (or 
should) allow me to print out 
what I write on either. BUTI t do 
not expect instant use! I e>:pect 
some down time learning the 
proper settings to get the printer 

So this is all for now and 1 hope 
10 give more information on the 
Z88inthe nefl issue. 0/0 

Donald S. Lambert 
738 Gunnar Ln. 
Forsyth, IL 62535 
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The QL Hacker's 
Journal (OHJ) is published by Tim Swenson ss a service to 
the QL Communily. The QHJ is freely distribulable. PasI 
issues are available on disk, via e-mail, or via the Anon- 
FFP server, garbo.uwasa.fi. The QHJ is always on the look 
□ul for anide submissioos 

QL Hacker's Journal 
c/o Tim Swenson 
2455 Medallion Dr. 
Union City, CA 945S7 
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Editors* Forum 

Qhis issue is far later thai I would like. Planning for 
the West Coast Sinclair Show (for which this issue 
is being prepared) took a fair amount of time. I've 
also been fiddling around the house getting It ready for 
guests coming to the show. Tve also been distracted by 
some projects from v^orfc I'm looking forward to running 
Linux on my Q40 and doing some "Professional" stuff with 
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Jell, after about a year, the Qliberalor Source Book 
project has reached a point that I have enough 
material to release. Since Qliberator was only a 
small part of the main document, I changed the title to the 
SuperBasic Source Book. Tlie focus was on Qliberator, 
Piogramming Toolkits, and Programming Tools. There is 
no sections on the SuperBasic language itSElf, The 
emphasis was on what is necessary to produce compiled 
professional code. I plan to add more information to the 
Source Book as I find the time A number of sections came 
from the QHJ, but were expanded with more information. 
The whole document (along with many others) can be 
found on my web page: 

w.geocites com/S ilicon Val ley/Pines/S 865/ 
issue covered two different languages, Perl and 
| |AWK. This started me thinking about other 

* ^languages that are available on the QL and who, if 

any, uses them A number of people have ported different 
languages to the QL, from the then popular XLISP. to the 
now popular Perl. Each language has it's own features and 
reasons for being. What 1 want to know is. who uses these 
languages? Has anybody done anything useful with these 
languages? Do you have a favorite language that you Uke to 
program in? If you use a language on the QL other than 
Assembly. C, SuperBasic, or Perl {we just touched it), let 
me know Tell me what language you use, what you use it 
for, how it suits youi needs, and provide an example of a 
useful tool you've created wilh the language. 

Structured SuperBasic 2.6.1 
ff r\ tl"^ project keeping me away from working on the 
I U J QHJ was updating Stmctured SuperBasic. IVe made 

-'a few minor changes to it that allows il to much 

more useful. I've also added a new utility that makes il SSB 
ZXirQLiveAlivel 



1 - Added a second command line argument of Starting 
Line Number. This was made so that SSB would be used 
with the Unix utility 'make'. Make, which comes w^th the 
C68 distribution, is a tool designed to only compile those 
sections of code that have changed Wilh SSB, if you have 
a program comprised of 5 program files, and you only 
change 1 one them, you have to run SSB on the whole lol 
(if you've used #jnclude statements). Using 'make', you 
leave out the #include statements and let make run the SSB 
filler for you. If you have only changed 1 file, the only that 
file is converted from __SSB to _BAS, then all of the _BAS 
files are added together into one file (using 'cat', another 
Unix utility). 

I'm not saying lhat we all should be using 'make', but I 
wanted the ability to use it built into SSB. 

2 - When using the command line, if SSB fails with an 
error, Ihe BAS file is deleted. This was need for the 
SSBGO, the utility mentioned below. 

3 - Better error reporting 

r==llhe new utiUiy is SSBGO. SSBGO automates 
I T J running SSB and Qliberalor SSBGO was designed 

-^to be used with MicroEmacs. From MicroEmacs, 1 

would saved a file, then use the execule-program command. 
I would enter: 

ssbgo flpl_file fi 
(the & is to EXEC it and not EXEC_W it) 
SSBGO will then run SSB on 'flpl^file^ssb' (_ssb is the 
default extension). Once it has file bas, il then load file bas 
in to SuperBasic, SAVEs the file to a tempormy file, checks 
il for the keyword MISTake and exisls if one exists. If not, 
it executes the LIBERATE command, which is the 
conmiand line interface to Qliberalor Qliberalor then fires 
up, compiles the program, and finishes So I have gone 
from having SSB source to a compiled program in just a 
few minutes, with only one command. SSBGO can be use 
with other edilors, you just need to CTRL-C out of the 
editor. EXEC SSBGO, and lei il run. 
SSB261_ZIP is available on my web page 
FileConflg 

If I'lnother program thai I have been working on is 
I A I FileConfig The short explanation is that FileConfig 
— — ^is an automated version of BasConfig, by O. Fink 
(and modified by Norman Dunbar and Dilwyn Jones). Wilh 
BasConfig, you cant edit an existing Config Block, only 
create a new one Widi FileConfig, you store the definition 
of a Config Block in a text file. If you need to edit a Config 
Block, edit the definition file, run FileConfig. and you have 
a new Config Block. 

0ileConfig is designed for programmers and has very 
minimal error checking It does not verify the data 
put into the Config Blocks, which means thai you 
could attempt to put the character A inlo a Byte item. If you 
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attempt this, the results will 
way of saying, "you are on your own." 
available on my web site 

Microemacs Macros 



I^TjjMicroEmacs 4.00 to the QL. He has added Pointer 

^Environment support for MicroEmacs, including 

menu items for all the commands. This has made 
MicroEmacs much more appealing and much easier to use. 
Just before this port, I had been playing with a little with 
configuring MicroEmacs and tinkering with macros. I have 
tried using macros in the past, but I had not quite figured 
out how to use them. With all the commands now available 
from puU-down menus, it is very easy to esecute a macro 
from a file, 

jf~pjlow that I know how to execule macros from a file, 
1^ )J the next thing was to figure out what would be 

I've looked over some macros that I found on the 
MicroEmacs web p^e. These macros helped create HTML 
files. These macros would query the user for any 
information it needed when creating HTML constructs. 
This means that an application could be written in macros, 
querying the user for certain data, and generate an end 
produa. Given the math functions built into MicroEmacs, 
one could write short little calculating programs, just tike 
we did, years ago, on the ZX-8!. 

I _ jlhe macro 1 wrote to show bow this works is a simple 
I I I mail-merge like application. The user creates a 

^document, with fields marked out where they want 

information to go. Here is a short example: 



"undefined', which is a nice 
your own." FileConfig is 



.n of 



mi 



Sfm 
@street@ 
Scitye 

Hello SEnamee, 

How are you today? How is your wife 
lwife@? 

re there are fields marked for first name, last name, 
llstreet, city, and wife's' name. Since this is a text 
1 an al sign (@) at the beginning and 
end of each field to make it distinct from the rest of the test. 
The macro will first query the user for the information and 
then it will go through the text file, replacing the marked 
fields with the user provided data. A macro like this can be 
usefiil if you are writing a Christmas letter that you in make 
a little more pei^nal, but still save time in writing. The 
macro is faster than editing the document yourself or even 
njnning the same search-and-replace queries 
The command 

set ivaciable @"String" 
tells MicroEmacs to query the user for input, showing 
"String" on the command line, and store the data in the 
variable %variable Without the al sign (@), the string 
"Siring" would be stored in %variahle. 

;This macro will query the user for 



; and theri ceplac 
ields iti the 
; text file. 

set %fname 0" First 



ith 



set Slname @"Last Name : " 

set Saddr ia"Street Address : " 
et%city @"City " 

iet iwlfe @"Wife's Fii:at Name ; " 
write-message "Replacing Text ..." 
replace-string "Sfnamel?'' Ifrrame 
: Need to goto to the beginning of the 



file 



■ the ; 



the 



the 



replac 



ling-of-file 



.ng-of-Eile 

■-string "ScltyP" icity 
beginning-of-file 
replace-string "@wife@" Jwife 
beginning-or-f lie 
write-roessage "Done ..." 
ffTTri'jhen Thierry introduced spell checking with 
|VVJ MicroEmacs 4 00. it only allowed spell checking of 

^ 'a single word, already marked I thought it would be 

a good idea to write a macro that would talk through a file 
and spell check them all Thierry has since mentioned that 
he is looking to expand the spell checking capability to be 
more user fiiendly. Bui, still the idea of writing a macro to 
walk through a file, word by word, seemed like a good 
challenge. Below is the macro, 
store-procedure get-word 



! force end-of - 
copy-region 



end-of-file 

set %end Scurline 

beginnmg-of-f ile 



Program IntomationallxatEon 

|r~T~1|bout 10 years ago I attended some vendor training 
|AJ on how to program and extend their particular office 

-^automation suite. One of the things that I took away 

from the training was how they designed Iheir system to 
adapt to many languages. Recently the method came to 
mind As I was thinking about the possibilities of using this 
method in my own programs, I pondered over it's 
limitations and what olher methods might be used 
After some thought 1 have considered throe different 
approaches to allowing a program to support multiple 



- Text File 

- One file per language 

- All languages stored in executable 

- One executable per language 
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fririlefore covering the different approaches, the main 
I D I thing that each approach hinges on is the storage of 

'all output messages in an array. Instead of having a 

line iike this: 

PRINT #3, "File Not Found" 

You would have something like this: 

PRINT !(3,me3Say_arr3yS 136) 
(rrnlince the output messages are not hard coded, the 
I O I [array can be changed to suit the language. For every 

^ 'possible output message you would have to put an 

entry in the array. Granted this will make reading and 
oiaintaining the source code more diflicuit, but it does make 
supporting different languages so easy, 
|P~~jlow the difference in each approach is how to store 

IN] the different arrays for each language. Each method 
— -^has some pluses and minuses and each have to taken 
into consideration for each programs needs. 
The first method mentioned. Teil File, is Ihe method that I 
learned in the training class The developers created a text 
file. In each language, of all of the possible messages. Each 
file would be given a different name. The progrBm would 
expect a certain file name. The current language would be 
renamed to that file name. When the program was executed, 
the program would read the file and load messages from the 
file into the auay. 

iT^Ihe problem with this method is Ihe overhead of 
I I I reading in the file. If you have a program that may 
' — ■ — ^be executed many times in a single session, the 
speed of the program will suffer fitim reading in the 
language file each time. If you are writing an application 
that once executed will run for a while, such as a word 
ir spreadsheet. One advantage of having that 
a file is that new laiigui^cs can be added 



to the program, with no change to the executable. 

f[ ll"^ °^ Batting around the overhead of reading in 

I U I a text file is to store all of the messages of all the 

^ ^languages in the executable and have a command 

line option or environment variable determine which 
language is chosen. With SuperBasic Ihe different messages 
would be stored in DATA statements When Ihe 
determination of which language is made, the program 
would read select which DATA statements to read into the 

Qhere are iwo disadvantages to this approach First, 
the space needed for each languages may add 
significantly ic " 



■ be recompiled 

frr^llnolher approach is to create the program the same 
I A I [way as the previous approach, but use conditional 

'compilation to create an executable for each 

language. This will cut down on the amount of space 
needed for the message data, but it docs mean that a 
different executable would have to be distributed for each 
language. If you included each language executable on Ihe 
distribinion media, then this ^proach may wotV. 
If r> It'^^" '"'^^ distribution of QL users and the many 
I (j I different languages, having a localized version of an 

^ 'appUcation may make an application more accepted 

in the community The difficult part will be in translating 
the messages into different languages. If the Text File 
approach is used, then users could translate the messages 
and dislribirte the new language file to other users, i believe 
something like this has been done with various diaionary 
files. 



TS-2068 ROM ByPass Board Features and Options II 

by the ImeWimam Petersen WDJUP 



I. The PULL rear connector is repeated so other 

accessories can be used, including a bank switching 

controller and back-f lane. 
Z. Use two 28 pin sockets for 'HOME ROM" and iwo 

for "EXROM". That way you can use RAM chips before 

burning EPROM's, You can plug in a duect replacement 

for 6264 RAM, but not 43256. 
3. When using EPROM, a 27128 chip can be used for 

"HOME ROM", leaving one socket empty. 
4 When using ROM for "EXROM", use 43256 chips for 

reasons of economy. (32K*8bits) 

5. "EXROM" memory from 0 to 32K is assumed to be 
43256 "ROM" or 27256 EPROM. (See Pig 2a,c) 

6. Write-protect switches are used when RAM takes the 
pbce of ROM. One covers "HOME ROM", the other 
CHUNKS UO thru #3 of "EXROM". 

7. Other switches allow RAM to be initialized (written) 
before being configured as "ROM" This allows HOME 
ROM and EXROM to be copied to external RAM. 

8. A jumper is provided to eliminate battery backup once 
EPROM has been installed in place of write-protected 
"HOME" ROM. 

Because bypass operations need BE lo operate, and 
external hanks have higher priority, the board must monitor 
BE' to avoid conflict. The cireuil shown breaks into t he BE 
ZXirQLivc Alive! ^ 



signal line to make this possible. 

The average user wants better operafion, more 
memory, more gadgets and software which makes use of 
them who can blame them, but not everyone has the 
technical knowledge and skill to do it on their own. 

The design presented here is hereby declared PUBLIC 
DOMAIN, with the blessings of The WIDJUP co. Suppliers 
arc fi-ee to manufacture, but it is strongly suggested that The 
WIDJUP CO, be conailled when doing 80. 



This BypHU Design Stands Alone^ 

Nevertheless. RGB video, analog signals, externa] 
power sources, bus re-powenng and atlachmcnt ot 
back-planes are features best located on the same board 
Provisiona for adding features would satLify those not vet 
ready for slot expansion 

It is quite easy to copy internal ROM to the bypass board. 

10 REM Fig 1: HOME ROM 
20 FOR N - 0 TO 163S3 
30 POKE N, PEEK N 



way to operate is with a t^mbirtation of Figure 1 
(with a single 27128) and Figure 2c. The switches and 
battery bat^p can be eliminated. All you need are the 
proper EPROMs and board The TS2058 will still operate 
without the board attached. If you like to change operating 
syslenis, like using SPECTRUM or CP/M. So you COULD 
have a set of EPROMs for each. This requires no special 
knowledge or procedures. There is. however, another way. 
If you like to try your tiand at making operating system 
changes by yourself, you c; 



4 0 NEXT N If you prefer to amply load c 



10 REM Fig 2a, b: EXHOM 
20 SAVE "EXROM" CODE 0, 0196 
30 LOAD "EXROM" CODE C, 8195 
Once an updated operating system is available, the n 



f several opeiating 



Figure ^c- EXROM Bypass /EPROM 



Hrt.CQM.| 




systems provided by others, you a 

The combination of Figure i and Figure 2a c»n hold 
any operating system including the original. Using a fairly 
simple procedure which can be prompted by a loaded 
program, any operating system can be "booted" 
into the TS2068 as software, just like other 
computers do 

The switches on the board are hardware in the 
figures, but they could easily be operated by 1/0, 
making booting entirely automatic. 

Once a system has been booted, you don't 
have to repeat it eveiy time you turn your 
computer off and on. Who said the TS2068 is an 
oiphan? 

It is probably best to explain a little bit 
about how these circuits work without getting 
too technical. 

If you ever tried writing to ROM, you 
know nothing happens All you can do is read 
from It. These boards have STATIC RAM 
covering the same address space as ROM That 
CAN be wrinen to. you just have to be carehil 
not to read anything back or confiision reigns 
This is solved by a switch which prevents 
reading from RAM 

It is interesting that a program can be 
running in ROM at the same time it is being 
"written to". There is no interference. In fact, the 
ROM program can make a copy of itself in 
RAM, down to the last detail. 

Ah hahl Now we can switch from ROM to 
RAM. switch the RAM to read-only, and you 
can't see anything different — so why do if 

You wouldn't, of course. Why copy ROM 
code when you can do better? The only reasons 
you might are to check out the hardware and to 
get a head start on making your own code 
modifications 

The rest of the circuitry makes sure thai not 
only wiil your present programs run without 
changes, but that features TIMEX left out WILL. 
It will if you want, that is. Should you want 
FORTRAN. Pascal, FORTH, or something else 
instead, it is possible. The TS2068 hardware is a 
marvel of design. It lends itself to 
bank-switching for large memory capacity It has 
no inherent problems with time-sharing. It is 
fast It has no problem working with an 
expansion back-plane, DMA, nor other bus 
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Function for Creating User Deflned Graphics (udgs) 
in HiSoft Pascal 



rtiefe ami Projirarn by David Solly 



Unlike Sinclair BASIC, HiSofi Pascal does nol have 
any reserved words like BIN to allow the user to create 
User Defined Graphics (UDGs). However, it is fairly simple 
to write your own flinclion for creating UDGs within Pascal. 
The program hsted below shows how 1 created the function 
LOADUDGO The fiinction has been written in such a way 
thai it allows UDGs to be defined &om elements supplied by 
the user through the keyboard. (Demo M\), or thiDuah hard 
coding within the program. (Demii W2i 
achieved is explained in the program nnjiiid 



be I 



t 



e i. K til » n t 
S I. e fii e n t 
element. 



( 

This is a HiSoft Pascal Program. 
This program must be compiled in : 
column mode. 

Program by David Solly 
Written: July 12, 1999 
Purpose: 

To demonstrate how user defined 
graphics (UDGs) can 

he defined within a HiSoft Pasct 
Program, 
} 

VAR 



GO, Gl, G2, G3, 



illow UDGs to t 



FUNCTION 
LC : CHAR; 

LGO, LGl, LG2, LG3, LGfl, LG5, LG6, LG7 
: INTEGER) ; CHAR; 



GC : CHAR; (To hold character 

:he UDG when found! 

LOC : INTEGER; {To hold ths UDG ; 



BEGIN 



LOADUDGO has been typed and debugged, the fiinction 
may be saved to a L"brary and called whenever required. Use 
and enjoy! 



IFind the UDG to defirii 
UDGs start at CHR(144), 

Characters after 'A' and ; 
usually referred to as 

Graphic B .. Graphic O.} 



GC :- CHRIORDIl 

(Find how many 
the alphabet} 
LOC := ORD(LC) 



LOC := (LOC ■ 
(Poke 1st elt 
then add 1 t 



■CI * 79); 

characters it is Int 
- ORD( 'A' ) ; 
address of the 1st 

rt of the UDG buffer 



POKE 
LOG 
POKE 
LOC ■ 

LOC . 
POKE 
LOC : 
POKE 
LOC : 
POKE 
LOC ; 
POKE 



LOC, 

"= LOC ■ 
LOC, L( 
= LOC H 
LOC, L( 

- LOC H 
LOC, LC 
= LOC H 
LOC, 

- LOC 1 
LOC, 



POKE (LOC 
LOADUDG 
END; 

BEGIN (Mail 
(DEMO #1 

through thi 
PAGE; 
(Fetch the letter 
HR1TE{ 'UDG to def 
READLN; (Required 
BEAD (LI ; 



Define UDG from c 
keyboard} 
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(Fetch the 8 elements for the UDGl 



WRITE I'i 

BEWDLK; 

REM) 1 GO) 

WRITE ( 'I 

READLN; 

READ(Gl) 

WRITE 1 '1 

REfiDLN; 

READ(G2; 

WRITER '1 

RERDLK; 

REMJIG3 

WRITE I '1 

READLN; 

R£fiD(G4 

WRITE I 

REMILN; 

READIGS; 



:TE ( 'Element 6 : 



READIES) ; 
WRITE ( ' I 
READLN; 
READIG7) ; 
(Define the DDGI 

GGC := LOADUDGIL, GO, Gl, G2, G3, 



GS, G6, Gl) \ 



; of the 



(DEMO «2: Exainplc 
Jefinitlon) 

(Space Alien HI) 
GGC2 LQftDUDGl'E 



3 of direct UDG 



60, 90, 126, 



FOR I 1 TO 64 DO 

WRITE(GGC2) ; 
WRITELN; 



(Space Alien «2) 

GGC3 := LOADUDGI'C, 24, 36, 24, 90, 
189, 153, 165, 129); 

{Write out 2 lines of the new UDG) 

FOR I 1 TO 64 DO 
WRITE (GGC3) ; 

WRITELN; 

WRITELN; 
END. 



. 1 TO 64 DO 



IXXXBItStSSl 



Z S B S 



Remeniberuig 3()-^ect>nt1s 
of gunfire ard death 
117 years igo ... / 
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guiltyP 
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Part-G Cont. 

5E4C F3 DI 

5E4D C9 RET 
This code decrypts Ihe headerless file we have just loaded 
in. The decrypter is CALLed lo, and it's ihe some one we 
had before (with the RBD). So, in actual fact, we can forget 
about the BASIC loader, just load in the headerless file 
normally and run our own decrypter. For now, just put a 
breakpoint al #5E4D and JP lo #5E3F. The RET is lo 
#9C40 

9C40 21 52 9C LD HL, )t9ca2 

9C43 01 90 01 LD BC,#0190 

9C46 16 A5 LD D, #A5 

9C48 7E LD A, |HL) 

9C49 AA XOR D 

9C4A 77 LD (HLl ,A 

9C4B 23 INC HL 

9C4C OB DEC BC 

9C4D 78 LD A, B 

9C4E Bl OR C 

9C4F C2 48 9C JP NZ, 9C4B 

This is a decrypter, and you can crack it in one of two ways. 
Firstly, you can copy if to somewhere else, put a breakpoint 
on the end, and run it from there, or you can replace the JP 
NZ.9C48 with JR NZ,9C48, Both do the same (bing. but Ihe 
JB NZ only uses two bytes. This means we can put a RET 
at #9C5I and CALL ihe decrypter So change #9C4F to 
»W. U9C50 to #F7 and #9C51 to #€•). then put a CALL 
UKAO and a breakpoint somewhere convenient (such as 
#5BO0) and run the decrypter fi-om there. When decrypted, 
the code continues at #9052. 

9C52 21 63 9C LD HL, #9C63 

9C55 11 95 FE LD DE,)fFE45 

9C58 01 90 01 LD BC, #0190 

9C5B ED BO LDIR 

9C5D 31 84 FD LD SP,#FDB4 

9C60 C3 45 FE JP #FE45 

This moves the code we've just decrypted lo #FE4S, sets 
the stack pointer lo #FD84, and JPs to IIFEA5 Put a 
breakpoint at #9C60 and JP to (i9C52. 
Now at #FE45, we come to the actual loading system itself 

FE45 3E 89 LD ft, #89 

FE47 11 00 18 LD DE, #1800 

FE4A DD 21 00 40 LD IX,«4D00 

FE4E CD AB FE CALL WFEAB 
This code loads in a headerless file with start #4000 and 
length #1800 (which is the display file for the screen). 
Nothing too unusual about that. . 

FE51 11 00 09 LD DE, #0400 

FE54 DD 21 FF SB LD IX, #5BFF 
FESa CD 2A FF CALL SFF2A 

... except that as soon as it's done that, it loads in a block 
with start «5BFF and length #0400 straight away. This 
block is "sandwiched" right next to the other block on [he 
tape. This particular block loads "backwards". 
FE5B 11 El 01 LO DE, SOlEl 

FE5E DD 21 IF FE LD IX,«FE1F 
FE62 CD FA FA CALL BFEFA 
And here's another block of the same kind, escept it's 
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loaded forwards this time What's worse is that it's going lo 
overwrite the code we're looking al now, so it must be a 
"modificalion" lo the loading system (similar to Ihe Mikro- 
Gen loader). To get round this, we would have to copy the 
code somewhere else, stick a breakpoint on the end, and tun 
it from there. Bui remember that the loading system was 
copied from address #9C63, so there is, in actual fact, a 
copy of the code anyway. You want to put a breakpoint at 
#9CB3 (the instruction after loading these three blocks), and 
JP to #9C63. Then start the tape and load in Ihe next 
headerless block. The loading screen will appear, and the 
game will load for about four seconds, then control will 
return to the disassembler. Now look at the code at #FE65 
FE65 11 ID 9F LD DE, «9F1D 

FE68 DD 21 IC FA LD IX, HFAIC 
FE6C CD 2A FF CALL «FF2A 
This code loads the main game backwards This will 
overwrite your disassembler, so you will have to put the 
NEW rouline al *FE6F (but write down all the bytes you 
are replacing, because you'll need to restore all the original 
code laler). Then you will have to go back and load Ihe first 
block, because there isn't a header for Ihe main game block 
Change #FE4D lo #01. #FES7 to fllO and #FE6I to #01 - 
this will make the computer try to load the three blocks into 
the ROM. Then rewind the tape back to the start of dlii 
headerless block. JP #FE4S, and start the tape. Upend 
loading Ihe whole block, the computer will reset. Load in 
your disassembler, and replace the code from the NEW 
routine lo the values they should be. Now you can lackle 
the fmal part of the loading system. 

FE6F II E4 12 LD DE, H2E4 

FE72 DD 21 FF FF LD IX, IfFFFF 
FE76 C3 70 FF JP #FF70 

FF70 3E 00 LD A, 0 

FF72 03 FE OUT (#FE) ,A 

FF74 CD IF FE CALL #FE:F 

FF77 21 43 FE LD HL, #FE43 

FF7A BE CP (HL) 
FF7B CA 09 FF JP a,#FF89 

FF7E 21 48 EE LD HL,#EE48 

FF81 01 FF FF LD BC, #FFFF 

FF89 11 49 EE LD DE,#EE49 

FFB7 ED BO LDIR 
The routine at #FE1F adds up all the memory in the screen 
lo get a value in the D register. Thi.s is then compared with 
the value of the byte at #FE43 If there is no match, all ihe 
memory is blanked out, so the value in ihe D register must 
be the same as the byte at #FE43. You should find that Ihe 
byte is#E6. You need lo know this for later on. 
FFB9 21 A3 FF LD HL,#FFA3 

FFBC 01 45 00 LD BC,#0045 

FF8F 7A LD A, D 
FF90 ftE XOR (HL) 
FF92 23 INC HL 
FF93 OB DEC BC 

FF95 Bl OH C 
FF96 C2 8F FF JP NZ,#FFeF 

This is all we can disassemble for the moment, because ihe 
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code from #FF89 lo SFF98 decrypts the final pan of the 
loader. Change the byte at #FF87 to #16, and the byte at 
#FFSS to #E6 (this is LD D,tfE6, which is used in the 
deciypter). put a breakpoint at #FF99. and JP to #FF87. 
Then continue the disassembly. 

FF99 CD 31 FE CaLL tfFE31 

FF9C 21 44 FE LD HL,#FE44 

FF9F BE CP (HL) 
FFAO C2 7E FF JP NZ,#FF7E 

This code checks the main game, coining out with a resuh 
in the E register. However, this value is never used, so you 
con ignore this whole routine. 

Following on 

FFA3 21 CO 5D LD HL, lt5DC0 

FFA6 01 30 75 LD BC,lt7530 

FFA9 CD D4 FF CALL !IFFD4 
FFAC 21 CO 5D LD HL, #5DC0 

FFAF Dl 30 75 LD BC,#7530 

FFB2 CD DE FF CALL (tFFDE 
FFB5 21 IC FA LD HL,#FA1C 

FFB8 11 IC FF LD DE, #FF1C 

FFBB 01 ID 9F LD BC, #9F1D 

FFBE ED B8 LDIR 
FFCO 21 10 A7 LD HL,#A710 

FFC3 22 36 5C LD |#5C36),HL 

FFC6 01 10 DF LD BC, #DF10 

FFC9 AF XOR A 
FFCA ED 42 SBC HL,BC 

FFCC 31 FF FF LD SP, FFFF 

FFCF ED 56 IWl 
FFDl C3 6F 00 JP tt006F 

006F E9 JP (HL) 
This routine runs the game Decryptera, moves the game 
into the right place, sets the stack and the intemipts, and 
puts the slflit address for the game in the HL register. 
Change the #005F at #FFD2 id somewhere where you can 
put a NEW routine {such as #5B00). because the 
disassembler will be overwritten. Then, change the value at 
#FFA! to 16, and the value at «FFA2 lo #E6 (because one 
decrypter uses the value in the D registei), and JP to 
#FFA2. When that's done, you can reload your 
disassembler, and hack the game using a forwards and 
backwards trace (but you won't be able lo run the code 
because some of it's missing!) 

Now we'll write a compiele hack for the game. You 
have to be a bit careiul about where you put your hack in 
memory, because a lot of memory is overloaded. The first 
ftee address we can put the code at is #FA1D. 
FAID DD 21 40 9C LD IX,#9C40 
FA21 11 90 01 LD DE,(t0190 

FA24 3E 07 LD A, #07 

FA26 37 SCF 

FA37 CD 56 05 CALL #0556 

FA2A 30 Fl JR KG, # FAID 
This loads in the first headerless block using the values set 
up in the BASIC loader. 

FA3C 06 FF LD B, #FF 

FA2E 21 40 9C LD HL, (I9C40 

FA31 7E LD A, (HL) 

FA32 ED 6 RRD 

FA34 23 INC HL 

Ffl35 10 FA DJNZ »FA31 

Fft37 06 FF LD B, #FF 
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FA39 7E LD A, (HL) 

FA3R ED 67 RRD 
FA3C 23 IKC HL 
FA3D 10 FA DJHZ, #FA39 
This decrypts the headerless block. 

FA3F 21 20 F7 LD HL, itF720 

FA42 22 4F 9C LD ■(#9C4F|,HL 

FA45 3E C9 LD A, #C9 
FA46 32 51 9C LD l#9C511,A 

FA49 CD 40 9C CALL #9C40 

This changes the JP NZ at #9C4F to a JR NZ and a RET, 
then calls the deciypter. 

FA4C 3E C3 LD A, #C3 
FA4E 32 83 9C LD («9C83),A 

FA51 21 5A FA LD HL, #FA5A 

FA54 22 84 9C LD Ht9CB4),HL 

FAS7 C3 63 9C JP tf9C63 

This puts a IP back to our hack at #9C83, and jumps lo 
#9C63 to load the first pan of the headerless block. 
FA5A 3E C9 LD A, #C9 

FA5C 32 6F FE LD (#FE6FI,A 

FA5F CD 65 FE CALL )(FE65 

This puts a RET after the code to load the resl of the game, 
then CALLs that loading procedure 

FA62 21 E6 16 LD HL,#16E6 

FA65 22 B7 FF LD HiFFB7),HL 

FA6e 3E C9 LD A, #C9 

FA6A 32 99 F LD (!tFF99),A 

FA6D CD 67 FF CALL iFF87 

This patches in the LD D,#E6, puts a RET at the end of the 
decrypter, and CALLs it. 

FA70 21 7E FA LD HL, «FA7E 

FA73 11 00 40 LD DE,#4000 

FA76 01 20 00 LD BC, #0020 

FA79 ED BO LDIR 
FA7B C3 00 40 JP #4000 

This code moves our hack into the screen memory (so it 
isn't affecled by the LDIR which overwrites it in the neW 
bil of code), and jumps to it there. 

FA7E 21 OB 40 LD HL,»400B 

FA81 22 D2 FF LD («FFD2),HL 

FAa4 16 ES LD D, #E6 

FA86 C3 A3 FF JP #FFA3 

This code replaces the JP #OOSF with a JP back to our hack 
{which is in the screen memory by this time), and IPs lo 
SFFA3. We have lo include the l,D D,fE6 again, because 
the value of DE was corrupted by the LDK. 
FAS 9 AF XOR A 
FASA 32 C6 CD LD (#CDC6(,A 

FA8D E9 JP (HL) 
This sets the infinite lives POKE, and does a IP (HL) to 
start the game. 

Phew! I hope you managed to get all thai, because it's 
really hard lo do without a Multiface. If you can do it, then 
you've definitely got the hang of things, so keep it up! 

SEARCH LOADER 
This loading system appears on every game ever writlen by 
Sieve Marsden (who wrote the original loading system), as 
well as a few others. You can recognize them by their fancy 
front end, which consists of a countdown timer, 
accompanied by animaled graphics and/or instructions, 
which appear as the game loads. The only game I've 
actually got at the moment that's got a Search Loader on it 
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Chip Fact LINE 0 LEN 736 

0 RANDOMIZE USR 24341 
The rest of the BASIC is a load of garbage which consists 
of the machine code for the game. It is stored in a similar 
way to that in the Mikro Gen loader. 2A34\ is 5F15 hejt. sc 
{lisassemble this adilress 
5F15 F3 DI 
5F16 21 00 40 
5F19 11 01 AD 
5F1C 01 FF 11 
5F1F 36 00 
5F21 ED BO 
This code bl^s out the : 
5F23 CD 32 5E 
It «5E32 



LD HL, #4000 
LD DE, #4001 
LD BC.SnFF 

LD (HL),0 

LDIR 



CALL (t5E32 
up the attributes for the screen 
i.e. red banners at the lop and bottom, black background 
with varying ink colors in the middle 



5F26 C3 38 
5F38 21 AB 5F 
5F3B 01 59 AO 
SF3E 31 00 5C 
SF41 3A Aa 5F 
I 57 



LD BC, )tA059 
LD SP, «6C00 
LD A, (ff6FA8) 



5F45 IE C 
5F47 7A 
5F48 87 
5F49 67 
5F4A 87 
5F4B 87 
SF4C 82 
5F4D 83 
5F4E 57 
5F4F 77 
SF50 23 



LD D,A 
B LD E,)tOB 

LD A, D 
ADD A, A 
ADD A, A 
ADD A, A 
ADD A, A 
ADD A, D 
ADD A,E 
LD D,A 
LD (HL),a 
INC HL 
DEC BC 
5F52 70 LD A,B 
5F53 Bl OR C 
5F54 20 Fl JB NZ, #5F47 

This rtmtine fills all of the memory above #5FAB with 
unexeculable code. It is, however, exliemely important 
code, as we shall see later on. 

5F56 CD 93 5F 
This routine at #5F93 just m 
bit more. 

5F59 CD eo 5D CALL tfSDBO 

The routine at ifSDSO scrolls in the title messages for the 
game, accompnied by annoying clicks. 

5F5C 3R 66 30 LD A, (ifS066) 

5F5F 6F LD L,A 

5F60 3A E6 60 LD A, (#60E6) 

5F63 67 LD H,A 

5F64 E5 PUSH HL 

5F65 3A 4F FC LD A, (t|FC4Fl 

5F6a 5F LD E,A 

5F69 3A OF 60 LD A, iif600F| 

5F6C 57 LD D,A 

5F6D DD El POP IX 

5F6F 37 SCF 

5F70 3E FF LD A, #FF 

5F72 14 rNC D 
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5F73 OS EX AF,AF' 

5F7 4 15 DEC D 

5F75 3A 66 63 LD A, (#6356) 

5F7a 6F LD L,A 

5F79 3A ES 63 LD A, (#63E6) 

5F7C 67 LD H.A 

5F7D E5 PUSH HL 

5F7E DB FE OUT (#F;E),A 

5FB0 IF BRA 

SFBl E6 20 AND #20 

5Fa3 F6 01 OR #01 

5FB5 4F LD C,A 

5F86 BF CP A 

5FB7 F5 PUSH AF 

5Fa8 3A 87 S5 LD A, (#6587) 

5F8B 6F LD L,A 

5FSC 3A 85 6 LD A, (#6435) 

5FBF 6 LD H,A 

5F90 Fl POP AF 

5F91 E5 PUSH HL 

5F92 C9 RET 
This code lakes values out of the garbage and puts them in 
certain registers. It then imitates the start of [he ROM 
loading routine, and puis some values on the stack. At 
W5F92, the values of the registers arc: Hl= #056B, 
DE=#03C3, [X=#8000. and the values on the stack are first 
#0S6B, then tfSOOO So, [his code will load a headerless file 
with start #8000 and length W)363, then will IP straight to 
SBOOO. We can do away with the BASIC loader al[ogelher 
in the final hack by mimicking the headerless loader. This 
is done using the following program. 

5B00 F3 DI 

5B01 31 OQ 5C LD 3P, #5C00 

5B04 DD 21 00 80 LD IX, #8000 

5B0B 11 C3 03 LD DE,#03C3 

5B0B 3E FF LD A, #FF 

5B0D 3 SCF 

5B0E 14 INC D 

5B0F Oe EX AF,AF' 

5B10 15 DEC D 

5B11 AF XOR A 

5B12 DB FE OUT (#FE},A 



5B14 



RRA 



5B15 E6 20 AND #20 

5B17 F6 01 OR #01 

5619 4F LD C,A 

5B1A CD 6B 05 CALL SQ56B 

5B1D 

This routine is slightly different than the one in the loader 
for tv/o reasons. Fiistlv. I've mil vnhius inlu the ruuisim 
direflly, rather than have their values taken fiom bytes in 
memory. Secondly, you aren't allowed by law to rip off 
someone else's code, if you directly copied a loading 
system into a hack, you could be sued In fact, someone 
was, oncei You're probably all right copying a five byte 
decrypler from Powerload across, because there really isn'l 
any other code which can do the job in the same way 
In general, 1 would say don't copy code into your hack 
unless you have to If you do. change it if you can so it does 
the same job in a different way. Copying 40 bytes of code 
directly out of a loading system is definitely out, and most 
magazines wouldn't print the routine anyway. 



There are a few commands we haven't met in the 
routine. EX AF", AP' concerns the swapping of registers. In 
the ZBO, in actual fact, there are two different sets of each 
register, although only one set can ever be used at once 
Think of it like a TV set, although both registers (A and A' 
in this case) are there, you can only see one at a time. EX 
AF,AF' exchanges both the A register and the contents of 
the flags. Don't worry any more about swapping re^siers 
for now. 

RRA rotates all the bhs in the A roister to the right. 
Actually, it doesn't quite do this, but we don't need to know 

If you're not using a Multifece, the garbage routine 
will have overwritten the disassembler, so reload it in 
anywhere below #8000. Then run the routine and restart the 
tape from where you left off A small part of the headerless 
block will load in. and control will retimi to the 
disassembler. Have a look at address #8000. 

aOOO D2 00 00 JP NC,#OO0O 

This resets the computer if the previous headerless block 
didn't load properly. 

B003 3E Oa LD A,#Oa 

8005 D3 FE OUT ittFEl,A 

This makes the border black, and sends a signal to the 
cassette recorder 

8007 D9 EXX 
EXX is a "general exchange" instruction, and changes the 
registers B,C,D,E,H and L for their alternate sets. 

BOOE OE 00 LD C,#00 

800A D9 EXX 

BOOB 26 00 LD H,ttOO 

300D 06 SO LD B, #80 

800F DD 21 IC ac LD IX, #aclC 

8013 16 05 LD D, #05 

8015 CD 41 83 CALL #8341 

8018 D2 00 00 JP NCttOOOO 

801B 06 Bl LD B,#B1 

eOlD 15 DEC D 

301E 20 F5 JR NZ, #B015 

This code loads in five bytes of t^e (the routine at ^^8341 
loads in information off tape into the address pointed to by 
the IX register), starting at fiSClC. Therefore, this tape 
routine will start loading code at #8C1C. 

8020 11 D8 12 LD DE, #7208 

3023 D9 EXX 

8029 OC INC C 

8025 D9 EXX 

8026 C3 7D B3 JP #B37D 
8370 2E 01 LD L, #01 
e37F CD 41 83 CALL #8341 
8382 D2 00 00 JP KC,#0000 
8385 3E CB LD A, KB 
8387 B8 CP B 

83SS 17 RLA 

8389 D9 EXX 

83BA 47 LD B,A 

B3BB E6 01 AND #01 

838D 3D INC A 

aSBF 11 6B BO LD DE,#B06B 

8392 lA LD A, (DE) 

8393 A7 AND A 

8394 C9 77 82 CALL NZ, #8277 

This loads in a set number of bytes from tape, and then 
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Its some sprites on 
duces all the men 
le the game loads. 

B397 CB 18 
8399 D9 
a39A CB 15 
839C 0,6 Bl 
e39E 30 DF 
83A0 7C 
B3A1 AD 
83A2 67 
3 3A3 7A 



JB t 



hS37F 



83M B3 

B3A5 20 CE 
This updates the computer ready 
animation sequence. 



LD A, H 
XOR L 
LD H,A 
LD A, D 
OR E 

JR MZ,liB375 



iQ the next loading and 



83BE 



CD 41 83 CALL #8431 

D2 00 00 JP NC,#O000 

3E EA LD A,#EA 

D2 00 00 JP NC,#O000 

42 LD B, D 

15 DEC D 

ID DEC E 

JP NZ, #8361 



83C0 C2 I 

This loads in some more bytes from tape. When these have 
finished, the computer will continue execution at address 
#83C3. The code beyond this address does nothing except 
fiddle about with registers, so there might as well be 
nothing there. The first bit of usefiil code will appear at 
#SCIC, but this hasn't been loaded yet. Instead, put a 
breakpoint at MSiCi. move the headerless loading routine 
so the CALL #0S6B is at «7FFD, and run die code from 
there. Rewind the tape a bit and reload in all of the main 
headerless block. When finished, you'll find the following 
oodeat#8C!C. 

SCIC 3E 5C LD A, #5C 

)0 40 LD HL,#. 



8C1E 21 
ac21 54 
BC22 5D 
8C23 EB 
8C2 4 4E 
BC25 23 
8C26 46 
ec27 23 
ec28 EB 



LD E 



1, H 



IHLl 



BC29 09 
BC2A BA 
8C2B 2 0 
BC2D 11 92 5C 
8C30 EE 5C 
BC32 28 EF 
8C34 E5 



INC HL 
EX D£,HL 
ADD HL, BC 
CP D 
JR NZ, 8C23 

DE, #5C92 



I8C23 



PUSH HL 

This routine adds up every single byte in memory to get a 
value in HL, which is PUSHed onto the stack. This value is 
important, because it is used in decrypting. This is what the 
garbage was all used for - to get the right value 




Place your ads here, it is free! 

Mail^-mail to: A. KAHAUE 3343 S FIAT ROCK CT SIERRA VISTA Az' 6S650-6874 
Please inform and/or update the Editor of any changes in your ad/s 



SPECTRUM for your 2068 

If you mc a LarKen LK-DOS OWDsr and would like to ran SPECTRUM 
programs on your sysian. we will supply a V2 EPROM. socket and 
74HCn2 for S12 which ioeludes shilling and handling. The mstal- 
lation instruclions are in your UuKcn manual. We shall ml be respon- 
sible for your insloll job. AERCO owners need only the EPROM for 
SIO forwarded to LarKen. 

Bob SvTOfier Address on paee 2 



747 ^ligljt ^imulntvr 

So you like to fly. the 747 Flight Simulaim for SPECTRUM by Den^ 
Ashton of DACC. Requires a SPECTRUM equipped 3068. Supplied 
on LarKen SSDD or DSDD LmKen disk for $10 vAich goes to Derek 
now vioriung 
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licme Electrcnics 
Service 

We have been a part of the Sinclair scene since 1982, repairing 
ZX Spectrums for Sinclair Research in England. 
We provide Sales. Service, and Sofhvare for the 

QL, Spectrum, ZX-81 and Z88. 

mvw.members. tripod, com/hes_computing/hes I .html 

E-Mail 74601, 1535@compuserve.com 
Hours of Operation is Monday - Frid^ 1300 hrs. to 2100 
hrs. central time zone. 
Phone 210 661-4376 
John R. Rish 
Home Electronics Service 
5222 Kazen Dr. 
San Antonio TX 78219 USA 



The John Oliger Co. 

11601 Widbey Dr. 
Cumberland IN 46229 
The JohD Oliger Floppy Disk System 
FOR THE TS-2068 
Disk Works 
ExPANSjoN Board 
2068 User Cartridge 
Disk Boards "a" & "B" 
2068 ParaUel Printer Port 
2068 EPROM Programmer 
2068/SPECTRUM Joystick Port 
DFh Mapped Universal I/O Port board 

User Manual only ; S5.00 {Read before yoti buy) 



Servloe For Amerioa's 

Favorite Home Computers and Their Accessories 

SINCLAIR 

TIMEX ADAMATARI IBM OSBORNE Tl 
COMMODORE TRS-80 
BUY SELL TRADE UPGRADE 

Repair Charge Examples 
TS-1000, ZX-81, 1016 RAMPack, Memotech. ZEBRA Talker, 
MIRACLE Cenu-onics. RAM Centranics. 
SS.OO each + pans & shipping. 
TS-2020. 204O, PC-8300, ZX-SO, TI-99, Z-SEO, Byte-Back, 
AERCO 206S Centronics, BASICare, LarKen RAMDisk 
SIO. 00 each + pans & shipping 
TS-206a, Spectmm, A&J MicrD, Miracle 5 1 2K. LarKen 1000 
& 205B FDI, Kempston FDI, Cumana FDL CST FDi. 
$15 00 each + pans & shipping. July 1, 1996 

Reasonable flat rate plus parts and shipping. 
Write or cali for prices, SASE appreciated 

COMPUTEE 
CLASSICS 

RT 1, Box 117 
Cabool MO 65689 
Phone 417 469-4571 417 467-4571 




S20 
$20 
$10 



QLAMBi 
QLuMSi 
SeekQL 
Upgrades $5 

914 Rio Vista Cir SW 
Albuquerque NM 871Q5 
(505) 843-B414 



Make David an Offer 
ZX-8in'S-1000 TS-206a Hardware Kits 
Real Time Clock I/O Controller RS-232 
Centronics l/F 16K & 64K RAM 300 BAUD 
Modem A-D Converter(assembled) 
BYTE-BACK INC 
536 Long Ter 
Leesville SO 29070 



ZX-TEXT - Word Processor 
ZX-CALC - Spreadsheet 
Business Software 
Cycle Accounting Financial Report Generator 
ZX-CALENDAR -TimeManagement 
ZX-81 TS-1000 TS-1500 TS-2068 

Albert F. Rodriguez 
A.F.R. Software® 
1605 Pennsylvania Ave 204 
Miami Beach FL 33139 
305 531-6464 



ARCHIVE Based QL Software 

OLerk - A complete financial program for the QL 
QLerk software (v3.21 ) with tutorial S29 
QLerk manual $29 
QLerk software S manual 550 

DBEasy - A menu based database system 

DBEasy software (v1 .6) $24 
DBEasy upgrade from VI .5 $7 

DBProgs - A toolkit of ARCHIVE procedures 

DBProgs software (v1.8) $18 
DBProgs upgrade from VI .7 $7 

DBTutor - A general purpose learning program 
OBTufor software(v1 .5) 312 

PC DBEasy - Just like QL DBEasy but you must have 

PC ARCHIVE to use It 

PC DBEasy software [v1.3) $12 
Bill Cable 
Wood & Wind Computing 
RR3 BOX 92 
Cornish NH 03745 USA 

Phone (603) 675-2218 



810 254-9878 

24 hours a day 
300 to 28,800 bps 
Supporting all Sinclair and Timex users Fidonet 
Echomail arefor Sinclair computers. Lots of new files 
for you to download such asTS-2068 emulator for 
those who use a PC give us a call and let us know 
what you want to see.Message and file areas. 
QL (ntemational, Quanta, QL Hacker's Journal, 
Spectrum/2068, ZX-81/TS-1000, Z83, NetH/lail, 
emulators, painter, FDFormat for QXL/QDOS, eic, 
Sysop John J ImpeUizzeri 
Co-Sysop Don Walterman 
Utica, Michigan, USA 

ZXirQUveAlivel 



IDomirc Cubes 

Hftrdwars & Software 

352 7'" Ave. TS'^ Fir, 
New York, NY 10001 
Phone 212 631-7563 
Fax 212 947-5069 Voice mail pager 917 490-8407 
Domino, gjbes^excelsior.net 



LIST 

Tkc Long LlanJ SinoUirA'imes Users Gr. 

Robert Ma Hoy, Treasurer 
412 Pacific St, 
Massapequa Parle, NY 11762 



NESQLUG 



NEWS 

New England Sinclair QL Users Group 

Ed Kingsley, Editor 
16 Highland Avenue 
Saugus MA 01906 
(781 ) 233-3671 EdK4a,aol,com 



QL 



Hacker's Journal 



Supporting All QL Progr 



Timothy Swenson, Editor 

2455 Medallion Dr. 
Union City, CA 94587-1914 
swen sontc@geocities.com 
htlp .//www. geocities. com/Si IconVa I iey/P i nes/SS65/ 



CATS 



Newsletter 

The Capital Area T/S Users Group 

Ban7 Washington 
7044 Cindy Ln 
/\nnandale VA 22003 
301 589-7407 
BBS 301 6e8W9 
Internet mfDOQ2(cgepfl2-epflbalto.or(i 



Alec Carswell 



Motivation 

1 6 Montgomery Ave 
Berth Ayrshire KA15 1EL 
United Kingdom 



;o Area Timex Users Gri 

Robert Swoger 
613 Pari<side Cir 
Streamwood IL 60107-1647 

630 837-7957 
CENG-1 08@emailmol.cx)m 



The Ramtop 

Newsletter 

The Greater Cleveland T-S User Group 

Thomas Simon Editor 

615 School Ave 
Cuyahoga Falls OH 44221 

E-Mail CIS 73177,333 
Jon Kaczor Produdion 
456S Williamson Ave 
Brooklyn OH 44144 
75363,1 127@iximpuservecQ)n 



Peter Lieberl-Adelt 
LUETZOW STR 3 
D-38102 BRAUNSCHWEIG 

GERMANY 
Email: p,liebert@t-online.d6 
http :/ /home.t-ooline.de/home/p . Iiebert/zx-leam. film 
Amateur Radio: DK4BF@DBQFC.tfNDS.DEU EU 



The ZX Spectrum 48/128 Emulator 
for IBM & Compatables: Z80 Version 

Turn your PC into a real ZX Spectrum 43/128 
Full Spectrum emulatjan, border, flash, beeper. Interface 1 , 
Microdrive In cartridge file, RS232 input and output redirection 
to file. COM or LPT. joystick support, 128K sound through 
Soundblastar or internal speaker, built-in monitor. 

Able to load ANY, ever protected or speed-saved program 
from tape, to save to tape, to redirect tape loads and saves to 
disk for easy tile access, 
=^ 2500 line English documentation. 

3, Windovra and [JesqView. 



- Fulisc 



Runs on any 640K PC; too slow for practical use on PC/XT's 
but fast enough on ATs, uses VGA/EGA/CGA or Hercules. 
This program costs US $20. You will receive a 3.5" DD disk 
(5.25" disks on request), and you'll be kept informed about up- 
dates. Please send bank notes (bills), name and address lo 
Gerton Lunter 
PO Box 2535 
NL-9704 CM Groningen 
Netheriand 

Ifyou send a cheque, please add US $15 ejctra and allow 4 
wedis for delivery, 
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The ROMDisk Fully Functional 

Extremely small board for the QL's ROM-Port, works like a 
permanent RAM disk. 
In order to be able to upgrade lo the color drivers, you need to 
have SMSQ/E. The norttuU SMSQ which is shipped with QXL 
card will not be able to handle more colors. 

SMSQ/E for the QXL 

As Aiorora owners will be able lo use more colors when the 
color drivers are avaflable, another offer for SMSQ/E for the 
Aurora plus GoldCard/Super/GoldCard 
SMSQ/E for the Super GoldCard 
QL Games & Upgrades QL Applications 
ProWesS + Applications 
Jochen Merz Software 
Im stillen Wtnkei 12 
47169 Duisburg, Germany 
« 0203-502011 Fax 0203-502012 
Credit Cards accepted 
http://www.j -m-s.com/smsq/ 
e-mail smsq@i -m-s . com 
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QL Today is published by Jochen Meiz Software. Jochen 
Merz has been supplying software for the QL for several years 
and has huilt up a good reputation for quality and fair trading. 
The representative in Britain is Miracle Sy.stems Ltd who take 
subscriptions and do Ihe distribution. 

Subscriptions 
Germany (+Gemnan add-on) DM 70 
England DM 60 £25 

Rest of Ihe world DM70 £30 

Back-issues are available for DM 12 (incl. postage) 
Checks should be made payable Miracle Systems Ltd. 
English Office 
Miracle Systems Ltd. 
20 Mow Barton 
Yates, Bristol 
United Kingdom BS17 5NF 
Tel. +44 1454 033602 Fax, +44 1'154 883602 
Editor 
Dllwyn Jones 
41 Bro Emrys 
Tal-Y-Bont, Bangor, Gwynedd 
United Kingdom LL57 3YT 
Tel. +44 1246 354023 Fax. +44 1246 354023 



Items for the Timex\Sinclair Computer 

Tioieworks Pragramming kit #1 ForT/S lOOO&ZXSi S4.95 
Mind ware Gulp Game Titnex 1000 & Sinclair 2XS1 S4.95 
Timei Horace & The Spiden for the 2068 SS .95 
Timex Sinclair 1000 software on tape 
Chess(16KRAM)qly5 price S2 95 ea 



The Challenger I qty 1 7 

price 12.95 ea 
MLndwareMW 100 plain 
paper printer for the 
TSlOOOor ZXBl com- 
puter made in the US. 
$45 00 
All ileniB are new. Please 
add $3 95 shipping lo all 

MC, VISA, American 
Express, phone 
717-748-1747 
Keith Electronics 
224 North Grove St 
Lock Haven, PA. 
17745 



Steamboat Lake, CO 




Kit 

S30 Plus SIO 

for S/H 
TS-2040 Printers 
16K RAM 

We Do Not Ship Out- 
side The US 8 Canada 
Checks, Money Orders and Visa or Mastercard 
CaU 212-675-8414 FAX 212-675-8980 

Zebra Systems, Inc. 
122 W26th St. Suite. 904 
New York, NY 10001 
Shipping is by UPS ground. 
B«sics ofTiniei Sinclair 1500/1000 BASIC 
Allen Wolach, Separately priced S12 95 
BASIC Basics for the Timei/Sinclair 1500/1000 
IMicliael BamettZ/Simon Bainell, Separately priced 112.95 
The Ins and Outs of the Timei TS-IOOO & ZX-81 
Don Thomasson, 112.95 
CompulerlnterTadng Technique in Science TS-I500/1000 
Paul Field &Jolui Davies, SI2.95 
ZX-Sl BASIC Proeramming (in Spanish language) 
Steve Vickers (Traducido y adaplado) A copy of tliis book is 
sliipped free for asking if you just pay for additional shipping 
cci^I Separately priced 110 



Sinclsir Resource 



Jacl<Doh3ny (Developer - 2068) 
627 Vera Ave 
Redwood City OA 94061 
John McMichaei (Developer - Graphics) 
1710Palmer Dr 
Laramie WY 82070 

Keith Wataoo (AERCO S Z6C Emulator) 
41634 Amberly Dr 
ML Clemens, Ml 46038 



RodGowen (RMG) 
14784 S Quail Grove Cir 
Oregon City OR 97045-8843 




JOHN J SHEPARD I 
281 130*^ ST 
OGDEN lA 50212 
< jshepard@netins.net = 

Mostly QL &TS-206a 



JACK BOATWRIGHT 
67325 FRYREAR RD 
BEND OR 97701 
^ jboatno4@outlawnet.com > 

Mostly ZX-8in"S-1000 & TS-2068 



QL TS-2068 ZX-81 

Books Magazines 

Software 



ZXir QLive Alive! 



